home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 033a / tdxl_3.zip / TDXL.DOC < prev    next >
Text File  |  1992-01-08  |  35KB  |  1,058 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                   TDXL.EXE - TSR Documentation Release 1.0c  
  9.  
  10.                      "TheDraw PCBoard X Format Loader"
  11.  
  12.  
  13.  
  14.                             - Operation Manual - 
  15.  
  16.  
  17.  
  18.                              Copyright (C) 1991
  19.  
  20.                               Fred Bertagnolli
  21.  
  22.                              All Rights Reserved
  23.  
  24.  
  25.  
  26.  
  27.                            TDXL was written using 
  28.                      Borland International Inc. TurboC(R)  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                   To Register this program send $15 U.S. to:         
  36.  
  37.                    
  38.                               Fred Bertagnolli
  39.                               TDXL Program
  40.                               745 Maple St.
  41.                               Ogden, Utah  84403 
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.                 ---------------------------------------------- 
  50.  
  51.                 Please support the "SHAREWARE" concept and the
  52.                 policies of all "SHAREWARE" software authors. 
  53.  
  54.                 ---------------------------------------------- 
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                   - 1 -
  63.  
  64.  
  65.  
  66.                           - INTRODUCTION to TDXL -
  67.  
  68.          
  69.     TDXL is a TSR (Terminate and Stay Resident) program that facilitates
  70.     the creation of PCBoard @X format color text screens.  TDXL allows
  71.     PCBoard BBS Sysops and Screen Designers to use TheDraw(TM) to create
  72.     Newsfiles, Bulletins and Welcome color text screens.
  73.  
  74.  
  75.  
  76.     Pressing Ctrl-T activates TDXL, while in TheDraw, and allows you to
  77.     View, Load and Save PCBoard @X formats directly.  This eliminates the
  78.     need to create ANSI.SYS color text screens and then convert them.
  79.  
  80.  
  81.     Note:  TheDraw(TM) is a well supported "shareware" color text screen
  82.            drawing program, available on many Bulletin Boards.  TheDraw
  83.            has many useful features for the creating screens.  It is
  84.            recommended that you use TheDraw version 3.3 or later with
  85.            TDXL.
  86.  
  87.     TheDraw(TM) is Copyright by Ian E. Davis and TheSoft Programming
  88.     Services.  Fred Bertagnolli is not an associate of Ian E. Davis.
  89.     Please support the "shareware" policies of TheDraw.
  90.  
  91.  
  92.  
  93.      ----------    IMPORTANT NOTICE TO ALL USERS OF TDXL   ----------
  94.  
  95.      IMPORTANT: TDXL will only work if TheDraw program name is unchanged.
  96.  
  97.         ***   DO NOT RENAME THEDRAW.EXE  to another .EXE name.   *** 
  98.  
  99.      ----------------------------------------------------------------
  100.  
  101.  
  102.                             - Release History -
  103.                                                                         
  104.      10-01-91   TDXL  Rel. 1a  1st Release.
  105.                                Posted on Salt Air as TDXL-PCB.ZIP
  106.  
  107.      10-03-91   TDXL  Rel. 1b  Minor bug fix for MCB's.
  108.                                Posted on Salt Air as TDXLPCB2.ZIP
  109.  
  110.      11-17-91   TDXL  Rel. 1c  Toys Option and Save/Append Option.
  111.  
  112.  
  113.  
  114.  
  115.  
  116.     This document is a generic ASCII file, 17 pages long.  You may
  117.     print TDXL.DOC by typing, at the DOS command line:
  118.  
  119.     COPY TDXL.DOC PRN
  120.  
  121.     -----------------------------------------------------------------
  122.  
  123.  
  124.                                   - 2 -
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                         - Overview of TDXL Features -
  131.  
  132.  
  133.  
  134.   o  TDXL was designed to replace CONVERT, EXLIST, and PCBdraw
  135.      when used with TheDraw.  Most PCBoard Sysops are familiar with
  136.      these programs, and their limitations and drawbacks.
  137.  
  138.   o  Your screen designs will display and scroll correctly when saved by
  139.      TDXL, without color wrap around problems, and are compressed to
  140.      a minimum file size.
  141.                
  142.   o  TDXL can grab color text screens while you are ON-LINE, and saves
  143.      the screen in compressed PCBoard @X format. 
  144.  
  145.   o  TDXL can be used with or without TheDraw.  For example, you can TYPE
  146.      an ANSI.SYS color screen, and save it to @X format.
  147.  
  148.   o  You can view PCBoard @X files anytime, even from a running program.
  149.  
  150.   o  Use of TDXL eliminates the need for duplicate ANSI files of your
  151.      PCBoard screens.
  152.  
  153.   o  Using TDXL with TheDraw is a better drawing environment than other
  154.      systems that write @X commands directly.    A few reasons are:
  155.      TheDraw supports a mouse, multiple pages, and can import many text
  156.      file formats.  Screen designing is EASY with TheDraw.
  157.  
  158.   o  TDXL supports loading @X screens or text files longer than 25 lines
  159.      and can load @X files to TheDraw pages.
  160.  
  161.   o  TDXL allows you to scroll through long text files or PCBoard format
  162.      files. You can insert just the Page you want directly into TheDraw
  163.      for further colorization/editing.
  164.               
  165.   o  TDXL is extremely easy to use.  It allows saving of 1 to 25 screen
  166.      lines, allows adding an @CLS@, and automatically compresses the
  167.      @X file to a minimum size.  You also have control over the last
  168.      CR-LF in the file.
  169.  
  170.   o  TDXL is written in 'C' by a professional programmer with 10 years
  171.      programming experience.  TDXL output has been heavily tested using
  172.      two different PCBoard BBS systems with no problems.
  173.  
  174.   o  Registered Users of TDXL will receive a password which enables
  175.      additional features built into TDXL, including the ability to
  176.      mirror (flip) horizontally and vertically and to view screens in
  177.      black and white mode.  Registration will also remove the "SHAREWARE"
  178.      reminder that appears on line 24 of the non-registered version.  We
  179.      do not apologize for this minor annoyance.  It is intentional.
  180.      Note that the reminder DOES overwrite part of line 24, and appears
  181.      each time you Load a file.
  182.  
  183.  
  184.  
  185.                                    - 3 -
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.            TDXL-PCB.ZIP should contain the following files:
  193.  
  194.            TDXL.DOC            TDXL.EXE             TDXL.HLP
  195.  
  196.            and the following PCBoard @X format sample screens.
  197.  
  198.            SAMPLE1.PCB         SAMPLE2.PCB          SAMPLE3.PCB
  199.            SAMPLE4.PCB         SAMPLE5.PCB          SAMPLE6.PCB
  200.            SAMPLE7.PCB         SAMPLE8.PCB          SAMPLE9.PCB
  201.  
  202.  
  203.  
  204.  
  205.                            - Table of Contents -
  206.  
  207.  
  208.           Introduction to TDXL ...............................  2
  209.  
  210.           Overview of TDXL features ..........................  3
  211.  
  212.           Files contained in TDXL-3.ZIP ......................  4 
  213.  
  214.           TDXL Software License Agreement ....................  5
  215.  
  216.           Distribution Policy ................................  5
  217.  
  218.           Warranty Disclaimer ................................. 6 
  219.  
  220.           TDXL Price List and Ordering Information ............ 7
  221.  
  222.           Installation and Removal of TDXL TSR ................ 8
  223.  
  224.           TDXL Main Menu ...................................... 9
  225.  
  226.           TDXL View Option .................................... 10
  227.  
  228.           TDXL Load Option .................................... 11-12
  229.  
  230.           TDXL Save Option .................................... 12-13
  231.  
  232.           TDXL Toys Option .................................... 13
  233.  
  234.           TDXL Help List for PCBoard Screen Designers.......... 14-16
  235.  
  236.           Acknowledgements .................................... 17 
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.                                    - 4 -
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.                      - TDXL Software License Agreement -
  255.  
  256.  
  257.      TDXL is not a Public Domain program and as such IS NOT "Freeware."
  258.      TDXL is Copyright (C) 1991 by Fred Bertagnolli, the sole author
  259.      and owner of the TDXL program and accompanying documentation.
  260.        
  261.      Non-registered users of TDXL are granted a limited 15 consecutive
  262.      day license to use TDXL for evaluation purposes only.
  263.  
  264.      Continued use of TDXL after the 15-day period requires registration
  265.      and payment for each copy of the program used.  Please support the
  266.      "Shareware" concept.
  267.  
  268.      TDXL may NOT be modified in any respect, for any reason, including
  269.      but not limited to, de-compiling, disassembling, reverse engineering,
  270.      or changing text in the TDXL.EXE program or documentation.
  271.  
  272.      Use of this software is just like a book, in that the software
  273.      may be used only by one person at a time, provided there is no
  274.      possibility of two people using the software at the same time.
  275.        
  276.      Registered owners of the software license may make one backup
  277.      copy of TDXL for archival purposes only, and to protect your
  278.      investment from loss.
  279.  
  280.      Registered owners of the TDXL software license are forbidden
  281.      from sharing information or passwords which allow non-registered
  282.      users to upgrade the software.  Release of your password shall
  283.      be interpreted as a violation of U.S Copyright Laws, intent to
  284.      defraud the author of his rights to the TDXL program, and cancels
  285.      your software license.
  286.  
  287.      The software license is non-transferable.
  288.  
  289.  
  290.  
  291.                         - Distribution Policy -
  292.  
  293.  
  294.      BBS Sysops may distribute only the shareware version of TDXL,
  295.      provided no distribution fees of any kind are charged, and
  296.      that the TDXL package and files have not been altered.
  297.  
  298.      "Shareware" distribution firms must acknowledge on the distribution
  299.      media, that a license is NOT being granted for the use of TDXL.
  300.  
  301.      Suggested BBS file listing for the TDXL-3.ZIP package is:
  302.  
  303.      TDXL-3.ZIP      Shareware TSR for TheDraw to create PCBoard @X
  304.                      ANSI color screens.  View, Load and Save @X format
  305.                      files from within TheDraw(R).
  306.  
  307.  
  308.  
  309.                                    - 5 -
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.                                - Disclaimer -
  317.      
  318.  
  319.       No warranties or guarantees of any kind are implied or given for
  320.       use of the TDXL program or the accuracy of this document.
  321.  
  322.              * * *   Use this program at your own risk.  * * *
  323.  
  324.       Fred Bertagnolli disclaims all warranties, expressed or implied.
  325.       In no event will Fred Bertagnolli be liable for any loss of profit
  326.       or other commercial damage, including but not limited to special,
  327.       incidental, consequential or other damages.  
  328.  
  329.  
  330.                    --------------------------------------
  331.  
  332.                            
  333.       This software requires an IBM compatible PC, DOS 3.0 or higher,
  334.       hard disk and 640K main memory recommended.
  335.  
  336.  
  337.       If you have a problem with TDXL, please contact the author via
  338.       mail and describe the situation (please read all the documentation
  339.       before contacting the author).  We have tested the program on
  340.       many different machines using DOS 3.3 and DOS 4.01.  Honest
  341.       criticism and suggestions are welcomed.   Requests for changes or
  342.       feature enhancements from registered users will be given first
  343.       priority.
  344.  
  345.  
  346.       Brands and product names mentioned in this document are trademarks
  347.       or registered trademarks of their respective holders or companies.
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.         
  355.  
  356.  
  357.        
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.                                    - 6 -
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.     Registration of TDXL is REQUIRED after the 15 day evaluation period.
  379.  
  380.  
  381.                            - TDXL Price List -
  382.    ---------------------------------------------------------------------  
  383.  
  384.       Evaluation Copy     $5.00    Plus a floppy disk supplied by you.
  385.  
  386.     Full Registration    $15.00    You receive "passwords" via U.S. Mail
  387.        for BBS Sysops              to remove "Shareware" notice and to
  388.                                    activate additional features of TDXL
  389.  
  390.     Full Registration    $20.00    As above.  Disk and "passwords"
  391.      with floppy disk              sent by mail.
  392.  
  393.           Upgrades to     $5.00    Plus floppy disk supplied by you. Disk
  394.       Registered User              must contain a fully operational TDXL,
  395.                                    as upgraded by previous "Password"
  396.                                    information.  (when available)
  397.         Tax Supported
  398.          Institutions    $55.00    Full Registration and disk by mail.
  399.      Corporations and           
  400.  All Commercial Users
  401.  
  402.    ---------------------------------------------------------------------  
  403.  
  404.    All prices are U.S. funds.  Foreign currency or foreign checks not
  405.    accepted.  
  406.  
  407.  
  408.  
  409.         All Check's or Money Orders Payable To:  Fred Bertagnolli
  410.  
  411.                Send to:    Fred Bertagnolli
  412.                            TDXL Program
  413.                            745 Maple St.
  414.                            Ogden, UT  84403
  415.     
  416.               --------------------------------------------    
  417.  
  418.    We may, at our discretion, send notification of upgrades and/or program
  419.    disks to registered users.   This will depend on user support of the
  420.    TDXL shareware policies.   We feel the asking price is well within the
  421.    budget of any Sysop.
  422.  
  423.    We ask for YOUR support, since TDXL is addressed to a relatively small
  424.    audience of users.
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                                    - 7 -
  434.  
  435.  
  436.  
  437.  
  438.                         - Installation of TDXL -
  439.  
  440.  
  441.   TDXL is a TSR.  Always load this program from the DOS command line
  442.   before running any other programs.  Never load any TSR while in a
  443.   DOS SHELL.
  444.  
  445.   Note: TSRs sometimes conflict with each other; therefore, it is
  446.         recommended that you do not have other TSR programs in memory
  447.         while running TDXL. If you do have multiple TSRs and experience
  448.         problems, then try loading the TSRs in a different order.
  449.  
  450.    All TDXL DOS command lines assume you are in the Directory where
  451.    TDXL.EXE is located.  We recommend installation of TDXL.EXE on your
  452.    hard disk.  TDXL.HLP must be in the same Directory as TDXL.EXE.
  453.  
  454.  * TO LOAD TDXL TSR...             at the DOS Command Line prompt type:
  455.  
  456.     TDXL
  457.  
  458.     TDXL now installed!
  459.     Press CTRL-T to activate the TSR
  460.  
  461.                        ------------------------------   
  462.  
  463.  * TO REMOVE TDXL from MEMORY...  at the DOS Command Line prompt type:
  464.  
  465.     TDXL QUIT
  466.  
  467.     TDXL now removed!
  468.  
  469.                        ------------------------------   
  470.                             
  471.  * ACTIVATING the TDXL TSR...
  472.  
  473.    Press CTRL-T (the hot key) while running THEDRAW.EXE.  A TDXL main
  474.    menu window pops-up and is ready to View, Load or Save @X files.  
  475.  
  476.                        ------------------------------
  477.  
  478.  * SPECIAL TDXL Command Lines...
  479.  
  480.   Special commands that some users may wish to use if the CTRL-T
  481.   hot key conflicts with other program controls (normally not used):
  482.  
  483.    TDXL wait     Puts TDXL on temporary hold, if it is already in memory.
  484.                  This deactivates the CTRL-T hot key.  
  485.  
  486.    TDXL restart  Restarts TDXL if it was on hold, and reactivates the
  487.                  CTRL-T hot key.
  488.  
  489.  
  490.    TDXL uses about 28K of memory when loaded.  We recommend that you
  491.    use the TDXL QUIT command line to remove TDXL from memory when you
  492.    have finished.  This will make the 28K of main memory available to
  493.    other programs.
  494.  
  495.                                    - 8 -
  496.  
  497.  
  498.  
  499.  
  500.  
  501.                       - TDXL Operation and Commands -
  502.  
  503.  
  504.          Main Menu: Pops-up after loading TDXL and pressing CTRL-T.  
  505.  
  506.  
  507.  
  508.                     -------------[ TDXL ]------------
  509.                     | Unregistered          Rel. 1c |
  510.                     |                               |
  511.                     |  V)iew      L)oad     S)ave   |
  512.                     |                               |
  513.                     | [Esc]:Exit  T)oys   Help:[F1] |
  514.                     |                               |
  515.                     |                               |
  516.                     |       PCBoard @X Screens      |
  517.                     --Copyright 1991 F. Bertagnolli--
  518.  
  519.  
  520.  
  521.  
  522.    The 4 options are for View, Load, Save a PCBoard @X file and Toys. 
  523.  
  524.    Press:  V, L, S, T to access menu options.
  525.  
  526.            T)oys option is available to registered users only and allows
  527.            the current screen to be mirrored horizontally or vertically.
  528.  
  529.    Press:  Esc to exit TDXL and return to TheDraw. 
  530.  
  531.    Press:  F1 to see the single help screen.  TDXL.HLP (the Help file)
  532.            must be in the same Directory as TDXL.EXE.    
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.                                    - 9 -
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.   V)iew:  View a PCB @X file or a text file, then restore previous
  565.           screen.
  566.  
  567.                       -------------[ View ]------------
  568.                       | Filename to View:             |
  569.                       |[_____________________________]|
  570.                       |                               |
  571.                       |  Display in Color : Y/N [ ]   |
  572.                       |  Reg. option                  |
  573.                       |                               |
  574.                       |                               |
  575.                       |                               |
  576.                       ----------------- [Esc]:Cancel --
  577.  
  578.  
  579.  o  Filename to View:  May have a Directory Path included with the
  580.                        filename; i.e.,  D:\DIR\PCBFILE.PIC
  581.  
  582.  o  You may press Esc at any time to cancel the field edit and
  583.     return to the Main Menu.
  584.  
  585.  o  If the 1st character of an existing file does not begin with @,
  586.     you are prompted: @ NOT FOUND! Proceed: Y/N [N].
  587.  
  588.     TDXL assumes that PCBoard @X files always begin with @. "Proceed"
  589.     is used to remind you the filename you entered is probably
  590.     not a PCBoard @X format file.  However, you may proceed with a Y
  591.     response and view ASCII text files.
  592.  
  593.     Files longer than 25 lines are prompted:
  594.  
  595.     [ More: Any Key or Esc ]
  596.  
  597.     at the bottom of the screen.  Pressing Any Key will scroll through
  598.     file, line by line.  Pressing Esc will show how many lines were in
  599.     that file, and waits for an additional Esc key press.   
  600.  
  601.  o  Note that TDXL does not support ANSI.SYS control codes.  Use TheDraw
  602.     to load in an existing .ANS file.  Then use TDXL to convert them to
  603.     PCBoard @X format.   Or from the DOS command line, TYPE FILE.ANS and
  604.     save the screen to @X format with TDXL.
  605.  
  606.  o  Display in Color? Y/N: [N]  is available only to registered owners.
  607.     This option is useful for viewing a PCBoard @X format file, in
  608.     black and white, and provides a means of seeing what the on-line
  609.     screen will look like if a user has color turned off.  We recommend
  610.     you check your screens in black and white mode, to be sure they
  611.     display as you intended.
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.                                    - 10 -
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  L)oad:  Loads a PCB @X file starting at (1,1).  If TheDraw(tm) is running,
  626.          prompts for PAGE #.  Draws to the video page and copies to TheDraw
  627.          page buffer. The current TheDraw Page should match PAGE # selected.
  628.                     
  629.                       -------------[ Load ]------------
  630.                       | Filename to Load:             |
  631.                       |[_____________________________]|
  632.                       |                               |
  633.                       |      TheDraw PAGE : 1-8 [ ]   |
  634.                       |                               |
  635.                       |   Page # is the active page   |
  636.                       |   of TheDraw, when running.   |
  637.                       |                               |
  638.                       ----------------- [Esc]:Cancel --
  639.  
  640.  o  Filename to Load:  May have a Directory Path included with the
  641.                        filename; i.e.,  D:\DIR\PCBFILE.PIC
  642.  
  643.  o  You may press Esc at any time to cancel the field edit and
  644.     return to the Main Menu.
  645.  
  646.  o  If the 1st character of an existing file does not begin with @,
  647.     you are prompted: @ NOT FOUND! Proceed: Y/N [N].
  648.  
  649.     TDXL assumes that PCBoard @X files always begin with @. "Proceed"
  650.     is used to remind you the filename you entered, is probably not
  651.     a PCBoard @X format file.  However, you may proceed with a Y
  652.     response and LOAD ASCII text files of any size.
  653.  
  654.  o  TheDraw Page: 1-8 is accessed only if you are currently running TDXL
  655.                       within TheDraw.  The default page is 1.  You
  656.                       should first be on the specified TheDraw Page
  657.                       before loading to it.
  658.  
  659.     For example: If you are on Page 1 and tell TDXL to load to Page 8, the
  660.                  current Page 1 screen will be temporarily overwritten.
  661.                  This happens because TDXL has no way of knowing what Page #
  662.                  you are currently displaying with TheDraw.  TDXL will load
  663.                  TheDraw Page 8 with the file, but Page 1 will not contain
  664.                  current screen data.  To refresh TheDraw screen, after
  665.                  exiting TDXL, use TheDraw command ALT-E PAGE# to redraw/or
  666.                  move to the desired Page #.
  667.  
  668.  o  Files longer than 25 lines are prompted with:
  669.  
  670.     [ More: Any Key or Esc ]
  671.  
  672.     at the bottom of the screen.  Pressing Any Key will scroll through
  673.     the file, line by line.  Pressing Esc will Load the current screen
  674.     into TheDraw, and will show you the number of lines in that file.
  675.     Pressing Esc again, exits TDXL and returns you to TheDraw.
  676.  
  677.     Lines longer than 80 characters are truncated.
  678.  
  679.  
  680.  
  681.                                    - 11 -
  682.  
  683.  
  684.  
  685.  
  686.     Load: continued
  687.  
  688.  o  After a Load, when running TDXL and TheDraw, TDXL moves the cursor
  689.     to position (1,1).  Line 24 of the non-registered version is
  690.     overwritten by intentional "Shareware" reminder.  If you have
  691.     not registered TDXL, please do not complain about this annoyance.
  692.  
  693.  o  By the way, the scrolling Load feature of TDXL is something TheDraw
  694.     cannot normally do with ASCII files.
  695.  
  696.  o  These PCBoard @Commands@ are ignored during View/Load, since they
  697.     are not displayed on-line and they do not expand any system information:
  698.  
  699.     @CLS@, @POFF@, @QOFF@, @PON@, @QON@, @MORE@, @PAUSE@ and @AUTOMORE@.
  700.  
  701.     All other @Commands@ may be included in a screen design: i.e., @USER@,
  702.     and will be Loaded with TDXL.  Except for @CLS@, SysOps should add
  703.     these non-expanding @'s to a saved file, manually.  Or put them on the
  704.     first line of the screen design, followed by an @CLS@ command.
  705.  
  706.  o  Note to Non-Sysops:  Most sysops do not like users to use any of the
  707.     color code commands in uploaded messages.  Please abide by local Sysop
  708.     customs, and do not use TDXL to create screens which are not Sysop
  709.     approved.  It is also worth mentioning, that @X color codes are not
  710.     recognized by many off-line mail reader programs, including SLMR 2.0.
  711.  
  712.                  -------------------------------------------   
  713.  
  714.  S)ave:  Saves the current screen to PCB @X format.   Prompts for number of
  715.          Rows to Save.  Allows adding an @CLS@.  Allows control over a CR/LF
  716.          at the end of the Saved file.  Save always starts at position (1,1).
  717.  
  718.                       -------------[ Save ]------------
  719.                       |                               |
  720.                       |     Ending Row   : 1-25 [23]  |
  721.                       |     Insert CLS   :  Y/N [N]   |
  722.                       |     Insert CR/LF :  Y/N [Y]   |
  723.                       |                               |
  724.                       | Filename to Save:             |
  725.                       |[_____________________________]|
  726.                       |                               |
  727.                       ----------------- [Esc]:Cancel --
  728.  
  729.  o  Ending Row: 1-25   Enter the last Row Number (screen line) you wish
  730.                        to save.  A column of Row numbers appears temporarily
  731.                        on the Left side of the screen, showing the current
  732.                        row number in Red.
  733.  
  734.  o  Insert CLS         If Y is selected, @CLS@ will be inserted at the
  735.                        first position in the Saved file.
  736.  
  737.  o  Insert CR/LF       If N is selected, the last line in the file will
  738.                        not have a Carriage Return / Line Feed combination.
  739.                        This is useful for displaying a full 23 lines when
  740.                        on-line, without scrolling off the screen.
  741.  
  742.  
  743.                                    - 12 -
  744.  
  745.  
  746.     Save: continued
  747.  
  748.  
  749.  o  Filename to Save:  may have a Directory Path included with the
  750.                        filename; i.e.,  D:\DIR\PCBFILE.PIC
  751.  
  752.  o  You may press Esc at any time to cancel any field edits and
  753.     return to the Main Menu.
  754.  
  755.  o  It is a good idea to View a saved file to make sure you have
  756.     exactly what you intended to save.  Registered users should also
  757.     View the file with No Color, to make sure the file displays as
  758.     intended, in Black and White mode.
  759.  
  760.  o  If a filename already exists, Save will prompt:
  761.     Overwrite filename? Y/N/A:[N]      A option is new, starting with
  762.                                        TDXL release 1.c  
  763.  
  764.        Entering  Y  Overwrites the file.
  765.        Entering  A  Appends to an existing file.  Useful
  766.                     for creating multiple page bulletins files.
  767.        Entering  N  Aborts the save process. 
  768.  
  769.     ------------------------------------------------------------------
  770.  
  771.  
  772.   T)oys:  This option is available only to registered users.  Pressing
  773.           T from the main menu prompts for the current TheDraw Page #,
  774.           if TheDraw is currently active.
  775.  
  776.           Press H or V to mirror the current screen.  Press Esc to
  777.           return to the main menu.  This option is useful for making
  778.           symmetrical screen designs.  Example: Copy Page 1 to Page 2
  779.           with Thedraw, then Flip page 2.  Copy the desired block of
  780.           the mirrored screen from Page 2 to Page 1 with Thedraw.
  781.  
  782.           TheDraw Page # should be the same as the your current
  783.           TheDraw Page being displayed.  The option is not prompted
  784.           if TheDraw is not currently running.
  785.  
  786.  
  787.                      -------------[ Toys ]------------
  788.                      |                               |
  789.                      |     TheDraw PAGE : 1-8 [___]  |
  790.                      |                               |
  791.                      |                               |
  792.                      |  Flip:    H)orz      V)ert    |
  793.                      |                               |
  794.                      |                               |
  795.                      |                               |
  796.                      ----------------- [Esc]:Exit ----
  797.  
  798.           Note that TDXL does not attempt to "fix or flip" box corners
  799.           or other specialized characters, when the screen is flipped.
  800.           The flip options are intended to be a drawing aid/tool.
  801.  
  802.  
  803.  
  804.  
  805.                                    - 13 -
  806.  
  807.  
  808.  
  809.  
  810.  
  811.             - If you have problems running TDXL and TheDraw -
  812.  
  813.  
  814.  o Do Not RENAME THEDRAW.EXE to some other name.  TDXL will only work
  815.    if THEDRAW.EXE filename is used to load and run TheDraw.
  816.  
  817.  o TDXL was designed for use with TheDraw versions: 3.3, 4.1, 4.3, and 5.0
  818.    TDXL may not work with older versions of TheDraw, since they have
  819.    not been tested.
  820.  
  821.  o TheDraw SETUP:  TDXL works correctly with TheDraw when the default
  822.                    page size of 80 x 25 is the current setup.  Other
  823.                    TheDraw page sizes will scramble TDXL @X file Loads.
  824.  
  825.  
  826.  
  827.  
  828.  
  829.    
  830.                 -  Using TDXL as a stand alone program -  
  831.  
  832.  
  833.              
  834.    TDXL can work outside of TheDraw to capture the current screen while
  835.    other programs are running.  
  836.  
  837.    For example:  ECHO OFF
  838.                  TYPE SCREEN.ANS (with ANSI.SYS color control codes)
  839.                  Press CTRL-T and SAVE the current screen with TDXL.
  840.  
  841.    For example:  While ON-LINE, press CTRL-T and SAVE the screen being
  842.                  viewed with TDXL, for later editing.
  843.  
  844.    Note:  TDXL may work with other screen drawing programs or editors, if
  845.           they use the video screen memory for screen storage buffers.
  846.           Use TDXL with other programs at your own risk.
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.                                  - 14 -
  871.  
  872.  
  873.  
  874.                 - A Help List for PCBoard Screen Designers -
  875.  
  876.   1. Limit the maximum size of your screens to 79 columns x 23 rows.
  877.  
  878.      TDXL supports a maximum page size of 80 x 25.  You are advised to limit
  879.      screen designs to 79 x 23, to allow for various communication programs.
  880.      Testing has shown some communication programs do not display 80 wide
  881.      screens correctly.  Using a maximum width of 79 characters seems to
  882.      correct this problem. (column 80 is blank)
  883.  
  884.   2. ASCII codes below 32 (decimal) may not display, or may have side
  885.      effects, if included in screen designs.  Use low ASCII codes with
  886.      caution, and test the resulting file on-line.  Example: ProComm
  887.      displays ASCII code 16, while Qmodem does not.
  888.  
  889.   3. Color 0,0 (Black on Black code X00) saves the last color.  TDXL
  890.      sets this color code, to Light Gray on Black, during View or Load.
  891.      A future release may support X00 save and XFF restore sequences.  
  892.  
  893.   4. If you are not a Sysop, do not create color PCBoard BBS messages,
  894.      without prior Sysop approval.   Messages with @X codes are not
  895.      supported by most offline mail readers.
  896.  
  897.   5. TDXL allows removal of the last CR/LF in the saved file.  This option
  898.      is available because PCBoard System Prompts begin with a CR/LF.
  899.      Assuming you have also included @CLS@ in a saved @X file and have 
  900.      removed the CR/LF from a screen with 22 lines, the next PCBoard
  901.      System Prompt will be on line 23, when displayed ON-LINE.
  902.  
  903.   6. A program called CONVERT.EXE (converts from ANSI to @X format)
  904.      incorrectly interprets low ASCII codes (31 or less) and can cause
  905.      undesired screen color wrap around.
  906.  
  907.      Advice:  Use TDXL with TheDraw to include low ASCII codes and to
  908.               correctly convert and compress @X files.
  909.  
  910.   7. Those who have used a program called PCBdraw are advised this
  911.      partial clone of TheDraw, does not support a mouse and the
  912.      non-registered version does not support multiple pages.  PCBdraw
  913.      cannot read ANSI.SYS files or other formats supported by TheDraw.
  914.  
  915.      Compression routines used by PCBdraw, attempt to minimize the
  916.      @X file size, and in doing so, ignore the possibility of color wrap-
  917.      around.  This flaw appears when PCBoard sends a file created by
  918.      PCBdraw, and the color screen scrolls or is longer than 23 lines,
  919.      when received by a user's communication program.
  920.  
  921.      TDXL fixes this problem by always ending a line with the default
  922.      DOS color of Light Gray on Black, while still compressing the @X
  923.      files to a minimum size.
  924.  
  925.      Advice:  Use TDXL with TheDraw to get screens that don't color wrap.
  926.  
  927.   8. TDXL allows specifying the number of rows to Save from 1-25, a
  928.      feature lacking in PCBdraw.   One- or two-line custom prompts
  929.      might be created by a Sysop, if PCBoard allows them.  Or you might
  930.      wish to create short screens, for faster ON-LINE displays.
  931.  
  932.                                    - 15 -
  933.  
  934.  
  935.  
  936.  
  937.      Help List: continued
  938.  
  939.  
  940.   9. Consistent use of TDXL with TheDraw will eliminate the need to
  941.      have backup ANSI.SYS files of your screen designs.  And @X files
  942.      are likely to be smaller in size, than an equivalent ANSI.SYS
  943.      file.
  944.  
  945.  10. Those who have used a program called EXLIST:  TDXL imports @X files
  946.      directly to TheDraw.  Imported files can then be save in ANSI format
  947.      or many other formats, if desired.
  948.  
  949.      Advice: Use TDXL with TheDraw to import @X and save to ANSI.
  950.      
  951.  11. PCBoard @X files do not support ANSI.SYS ESC GOTO sequences;
  952.      therefore, screens designed for PCBoard systems cannot display
  953.      TheDraw Animation type files in @X formats.
  954.  
  955.  12. To create multiple page Newsletters and other long @X displays:
  956.  
  957.      Easy Method: Use an existing filename when Saving and Press A
  958.                   to APPEND the current screen to the existing file.
  959.  
  960.      Or : SAVE EACH PAGE with TDXL.  Then concatenate the files
  961.           with the DOS COPY command:
  962.  
  963.           COPY PAGE1 + PAGE2 + PAGE3 + ...
  964.  
  965.      You can scroll through and verify the long file, with TDXL, after
  966.      joining individual pages together, using the View option.
  967.  
  968.  13. For faster and smaller PCBoard BBS ON-LINE screens, create designs
  969.      containing mostly blank spaces.   Screen designs have blank spaces
  970.      on the RIGHT SIDE of the screen will display faster than screens
  971.      surrounded with a box design.
  972.  
  973.      TDXL's compression scheme does not include blank spaces on the RIGHT
  974.      SIDE of the screen in the Saved file, if the spaces are drawn on a
  975.      BLACK background.
  976.  
  977.  14. If you need to have a series of non-expanding PCBoard @Commands@
  978.      in the file, consider putting them in the first line of the
  979.      file;  i.e.,  @QOFF@@CLS@  works nicely.  TDXL will ignore these
  980.      "invisible codes" when you Load a file containing them.  However,
  981.      they can be placed in a Saved file, by typing them in TheDraw before
  982.      you Save the file.  Test all files containing @COMMANDS@, on-line.
  983.  
  984.  15. If PCBoard users complain about not seeing the last part of the
  985.      LOG OFF screen, consider putting in @PAUSE@ in the last line
  986.      of the PCBoard @X file.  That way, they can press a key to
  987.      continue or they will automatically be logged off in 10 seconds.
  988.      They will see the whole LOG OFF screen, without truncation.
  989.  
  990.  16. Add variety to your system by rotating Welcome screens.
  991.      Ask your users to create Welcome screens.
  992.  
  993.  
  994.                                    - 16 -
  995.               
  996.  
  997.  
  998.                        - Sample PCBoard @X screens -
  999.  
  1000.        The TDXL-PCB.ZIP file should contain several sample screens.
  1001.        Permission is granted to change or use these screens if you
  1002.        wish to use them on your system.  One of these files is an
  1003.        example of a PCBoard @X screen containing more than 25 lines.
  1004.  
  1005.  
  1006.                             - Acknowledgments -
  1007.  
  1008.  
  1009.     Thanks to all those who helped with the TDXL program development.
  1010.  
  1011.      Lynn Walker   Sysop of "The TIMEX BBS"         1-801-394-5010 (BBS)
  1012.      Bart Flint    Sysop of "The Year 2000 Network" 1-801-547-0607 (BBS)
  1013.  
  1014.      Special THANKS to:
  1015.  
  1016.      Glenda Moore, CoSysop of "Year 2000 Network and Timex BBS"
  1017.  
  1018.     Many ideas incorporated into TDXL were included at Glenda's suggestion.
  1019.     Glenda gets all the credit for debugging, testing, and putting up with
  1020.     a sometimes cranky programmer.  The sample PCBoard screens include
  1021.     examples of Glenda's PCBoard screen designs.  Glenda has designed
  1022.     hundreds of PCBoard Welcome screens and now uses TDXL because it
  1023.     makes previous methods obsolete.
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.    -----------------------------------------------------------------------
  1053.    TDXL.EXE and TDXL.DOC      Copyright (C) 1991          Fred Bertagnolli
  1054.    -----------------------------------------------------------------------
  1055.   
  1056.                                 - 17 -
  1057.  
  1058.